home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -seriously_amiga- / shareware / programming / mui / mcc_date / docs / english / date_mcc.doc next >
Text File  |  1997-12-06  |  15KB  |  456 lines
  1.  
  2.                       Table of Contents
  3.  
  4.   Copyright                   - Copyright information
  5.   Distribution                - Copying conditions
  6.   Disclaimer                  - Legal Information
  7.   Trademark                   - Trademark information
  8.   Support/Updates             - How to get updates and support
  9.   Author                      - How to reach the author
  10.  
  11.   Description                 - What is Date.mcc?
  12.   Requirements                - Requirements for using Date.mcc
  13.  
  14.   Installation                - How to install Date.mcc
  15.  
  16.   Developer Info              - Information for developers
  17.  
  18.   History                     - Revision history of Date.mcc
  19.   Todo                        - Todo list
  20.   Known problems              - List of known problems
  21.   Acknowledgments             - Acknowledgments
  22.   Please rate                 - Please rate Date.mcc
  23.   Subclasses                  - Subclasses build on Date.mcc
  24.  
  25.  
  26.  
  27. Copyright
  28. ---------
  29.  
  30. This software and its documentation are copyright 1996-1997 by Kai Hofmann. All
  31. rights reserved!
  32.  
  33. - Permission for COMMERCIAL USE is only given by an extra available commercial
  34.   license that must be validated!
  35.   Contact me directly for this license, because it will be individually handed
  36.   out per your needs!
  37.  
  38. - Permission is hereby granted, without written agreement and without license,
  39.   to USE this software and its documentation for any NON-COMMERCIAL purpose,
  40.   provided that the above copyright notice and the following paragraph appear
  41.   in all copies of this software (Non-commercial includes Giftware!).
  42.  
  43.   Please send me a full version of your product at no cost including free
  44.   updates!
  45.   Extra money is welcome (For Bank Account see author - but *ONLY* send in DM
  46.   to this Bank Account!).
  47.  
  48.  
  49.  
  50. Distribution
  51. ------------
  52.  
  53. Permission is hereby granted, without written agreement and without license or
  54. royalty fees, to copy and distribute this software and its documentation for
  55. any purpose, provided that the above copyright notice and the following
  56. paragraphs appear in all copies of this software, to:
  57.  
  58. - All who will distribute this software for free!
  59. - All free accessible INTERNET servers!
  60. - All Aminet® sites
  61. - Fred Fish for his great Amiga-Software-Library
  62. - The German SAAR AG PD-Library
  63. - Angela Schmidt's Meeting Pearls series
  64. - All others who do NOT take more than US$ 5.- for one disk that includes this
  65.   software!
  66.  
  67.  
  68.  
  69. IMPORTANT NOTE:
  70.  
  71. This package may not be included on any further Aminet CD-ROMs unless authors
  72. contributing their software to the CD-ROM, (without mentioning distribution
  73. "NoCD") are granted a copy of the CD *completely* *free* *of* *charge*.
  74.  
  75. The Meeting Pearls IV CD-ROM demonstrates that a Freebie policy is also
  76. possible with "very-low-budget" CD-ROMs (*), so Aminet should quickly
  77. re-establish the same Freebie policy it used up to Aminet CD 13.
  78.  
  79. (*) Suggested retail price for MP4 is DM 14,95/US$ 12/£ 8.95.
  80.  
  81.  
  82.  
  83.  
  84. DISCLAIMER
  85. ----------
  86.  
  87. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  88. LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR OTHER
  89. PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  90. EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  91. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
  92. QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
  93. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  94.  
  95. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
  96. COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM AS
  97. PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
  98. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  99. THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  100. INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE
  101. PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY
  102. HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  103.  
  104. THE AUTHOR HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
  105. ENHANCEMENTS, OR MODIFICATIONS.
  106.  
  107.  
  108.  
  109. Trademark
  110. ---------
  111.  
  112. DateLib is a trademark of Kai Hofmann
  113.  
  114. Amiga, AmigaDOS, AmigaGuide and Workbench are registered trademarks of Amiga
  115. International, Inc.
  116. Aminet is a registered trademark of Stefan Ossowskis Schatztruhe GmbH
  117. SAS/C is a registered trademark of SAS Institute Inc.
  118.  
  119. All other trademarked names used herein are used for the purposes of
  120. identification and for the benefit of the trademark holder. No infringement of
  121. trademarks is intended. Trademarks remain the property of the trademark holder.
  122.  
  123.  
  124.  
  125. Support/Updates
  126. ---------------
  127.  
  128. - Updates will be available via Aminet®
  129. - Support will be available via the authors email address and via
  130.   http://home.pages.de/~i07m/amiga/mui/Date.html
  131.  
  132.  
  133.  
  134. Author
  135. ------
  136.  
  137. Kai Hofmann
  138. Arberger Heerstraße 92
  139. 28307 Bremen
  140. Germany
  141.  
  142. Phone: (+49)-(0)421/480780
  143. EMail: i07m@informatik.uni-bremen.de
  144.        i07m@zfn.uni-bremen.de
  145. IRC  : PowerStat@#AmigaGer
  146. WWW  : http://home.pages.de/~i07m/
  147.  
  148.  
  149.  
  150.  
  151. Description
  152. -----------
  153.  
  154. Date is an abstract Custom Class of the Magic User Interface © by Stefan Stuntz.
  155. It's a subclass of notify-class and only usable for developers who want to
  156. build subclasses of Date.mcc!
  157.  
  158. The idea of this class was born during developing my Gregor application.
  159.  
  160. MUI abstract public custom class allowing easy
  161. handling of dates. Because it is abstract it is only usefull for developers
  162. who are working with classes that are based on Date.mcc (like DateString.mcc),
  163. or who want to build their own classes based on Date.mcc.
  164.  
  165. Date.mcc features:
  166. - Handles years from 8 to 8000
  167. - Supports the Gregorian calendar reform
  168. - Supports MUIM_Import and MUIM_Export
  169. - Supports drops of other date objects and date-strings
  170. - A week can begin with any weekday
  171. - The date can be read as day/month/year format or as JD or MJD
  172. - The date range can be restricted
  173. - Method to set the current date
  174. - Methods for increasing and decreasing the date
  175. - Method to compare with another date object
  176.  
  177.  
  178.  
  179. Requirements
  180. ------------
  181.  
  182. - MUI 3.1 (Version 12)
  183. - date.library
  184.  
  185. - To use the Greek MCC-Install script you need the
  186.   "Greek Workbench" © AC Software
  187.  
  188. - To use the Russian MCC-Install script you need
  189.   "Rusifier" © Dmitry Mikhilov
  190.  
  191.  
  192.  
  193. Installation
  194. ------------
  195.  
  196. Please only install Date.mcc when you are a developer!
  197.  
  198. Use the installer script!
  199. (The Installer must be in your system-path!)
  200.  
  201. If you use an Installer prior to V42 you should set the LANGUAGE Tooltype to
  202. your language. Installer V42 and better automatically use your current locale.
  203.  
  204.  
  205. Please note that the installer-script is very special, because:
  206.  
  207. - It features uninstallation
  208. - It is automated
  209. - It is very flexible
  210. - It is very intelligent (for an installer-script ;-)
  211. - It uses WrapGuide (if present) for the AmigaGuide®
  212.   documentation if running under a pre V39 system.
  213. - It can be reused by (hopefully) all other MUI custom classes, because the
  214.   authors of custom classes need to only change a few things:
  215.  
  216.   * The #copyright variable
  217.   * The #min_os_version and #min_os_revision variables
  218.   * The #min_mui_version and #min_mui_revision variables
  219.   * The #language_mcc and #language_mcp variables
  220.   * The P_CustomExists, P_CustomInstall and P_CustomUninstall procedures
  221.   * The 'APPNAME' tooltype within the MCC-Install icon.
  222.  
  223.  
  224.  
  225. Information for Developers
  226. --------------------------
  227.  
  228. There is no multiple inheritance for Boopsi/MUI for the moment, so we haven't
  229. any chance to create a real Date basis-class. But there is another way to have
  230. the same result (compatibility for all classes that are dealing with date).
  231. The solution is called interface inheritance like it was done with IDL for CORBA.
  232. Interface inheritance has some advantages and some disadvantages.
  233.  
  234. The advantages are:
  235. - (Pseudo) multiple inheritance
  236. - The same interface for all classes dealing with Date
  237.  
  238. The disadvantages are:
  239. - Every one who wants to subclass Date.mcc must include the code for Date.mcc
  240.   in the new subclass.
  241.   But this can be easier done by using the DateLib and/or the Amiga-OS support
  242.   functions.
  243.   Btw. the same happens for IDL, but by using C++ it is possible to inherite
  244.   the implementation.
  245.   A future release of Date.mcc will include a full skeleton C code, so that
  246.   everyone can start his subclasses on this.
  247.  
  248.  
  249. Please note, that you can not compile Date.mcc!
  250. This is because I don't want to distribute the folowing files at the moment:
  251. date.h, datesys.h, date_pragmas.h
  252. These files are part of my DateLib (TM) project. A new release will be
  253. available in 1997.
  254. Please note that the supplied source is version 12.0!
  255.  
  256.  
  257. Btw. it would be wise to use a
  258.  
  259.  SetAttrs(obj,
  260.             MUIA_Date_Year,   year,
  261.             MUIA_Date_Month,  month,
  262.             MUIA_Date_Day,    day,
  263.           TAG_DONE
  264.          );
  265.  
  266. instead of single set()'s.
  267.  
  268.  
  269.  
  270.  
  271. History
  272. -------
  273.  
  274. 27.11.1997 -    First release on Aminet
  275.  
  276.  
  277.  
  278.  
  279. Todo
  280. ----
  281.  
  282. - Notify on locale preference change (country/language)
  283.  
  284.  
  285.  
  286.  
  287. Known problems
  288. --------------
  289.  
  290. - Old versions of the program called 'PhoneCost' written by André Schenk
  291.   <schenkae@tick.informatik.uni-stuttgart.de> installed another
  292.   'date.library' into 'Libs:'.
  293.  
  294.  
  295.  
  296.  
  297. Acknowledgments are going to the following people:
  298.  
  299. Rita Reichl         : for correcting my English and being my inspiration
  300.  
  301. James Cooper,
  302. Steve Krueger,
  303. Doug Walker         : For supporting SAS/C® after SAS suspends the support.
  304.  
  305. Stefan Stuntz       : for the Magic User Interface and for his support
  306. Klaus Melchior      : for the MUI custom class support
  307. Martin Huttenloher  : for MagicWB
  308. Udo Schuermann      : for WrapGuide
  309. Stefan Kost         : for ag2txt
  310. Jürgen Kohrmeyer    : for the rexxtricks.library
  311.  
  312. Henning Thielemann  : for help with the Cluster interface
  313. Eric Gerard         : for his great icons
  314.  
  315.  
  316.  
  317. Please rate
  318. -----------
  319.  
  320. Please rate Date.mcc and MCC-Install. To do so, send an email to
  321. aminet-server@wuarchive.wustl.edu with the following content:
  322.  
  323. RATE dev/mui/MCC-Install.lha <num>
  324. RATE dev/mui/MCC_Date.lha <num>
  325.  
  326. where <num> is a mark from 0..10 with 10 being the best.
  327. You can rate several programs in one mail.
  328.  
  329. Thank you!
  330.  
  331.  
  332.  
  333. Subclasses
  334. ----------
  335.  
  336. The following classes are build on Date.mcc:
  337.  
  338. DateString.mcc:
  339.    By Kai Hofmann <i07m@informatik.uni-bremen.de>
  340.    http://home.pages.de/~i07m/amiga/mui/DateString.html
  341.    Aminet:dev/mui/MCC_DateString.lha
  342.  
  343. MonthNavigator.mcc:
  344.    By Kai Hofmann <i07m@informatik.uni-bremen.de>
  345.    http://home.pages.de/~i07m/amiga/mui/MonthNavigator.html
  346.    Aminet:dev/mui/MCC_MonthNavigator.lha
  347.  
  348.  
  349.  
  350.  
  351.                       This is a custom class of the
  352.  
  353.  
  354.                         MUI - MagicUserInterface
  355.  
  356.                  Copyright © 1993-1997 by Stefan Stuntz
  357.  
  358.  
  359. MUI is a system to generate and maintain graphical user interfaces. With
  360. the  aid  of  a  preferences program, the user of an application has the
  361. ability to customize the outfit according to his personal taste.
  362.  
  363. MUI is distributed as shareware. To obtain a complete package containing
  364. lots of examples and more information about registration please look for
  365. a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
  366. your local bulletin boards or on public domain disks.
  367.  
  368.           If you want to register directly, feel free to send
  369.  
  370.  
  371.                          DM 30.-  or  US$ 20.-
  372.  
  373.                                   to
  374.  
  375.                              Stefan Stuntz
  376.                         Eduard-Spranger-Straße 7
  377.                              80935 München
  378.                                 GERMANY
  379.  
  380.  
  381.              Support and online registration are available at
  382.  
  383.                           http://www.sasg.com/
  384.  
  385.  
  386.  
  387.                  This product is based on or uses parts of
  388.  
  389.                      MagicWB - The Workbench Enhancer
  390.                      --------------------------------
  391.  
  392.                  Copyright © 1992-1997, Martin Huttenloher
  393.  
  394. If  you  use  and like this product you should very much consider to take a
  395. look  at  MagicWB,  which  is the authentic source of the style, colors and
  396. design  elements  contained  in  this  package.   It  features  hundreds of
  397. original  icons,  patterns, image-drawers,  dock-brushes and some specially
  398. designed  high-quality  fonts  to  improve the comfort & legibility of your
  399. daily Workbench session.
  400.  
  401. What  is  MagicWB?   MagicWB  is  a full replacement for the Graphical User
  402. Interface  of the Workbench and has become the standard visual interface on
  403. the  Amiga.  Over the last years MagicWB has received various merits and an
  404. overwhelming  response from Amiga magazines and users worldwide proclaiming
  405. it  "a  must  for  all  Amiga  users".   Even  commercial  applications are
  406. supporting the multi-colored look & style of MagicWB.
  407.  
  408. Get yourself the latest version of MagicWB and see for yourself the wonders
  409. it  can  do by automatically transforming your old and dull Amiga Workbench
  410. into  an impressive workstation environment that will be the envy of all PC
  411. Windows  and  Mac users.  Update yourself to the state-of-the-art workbench
  412. standard  everyone uses on the Amiga!  It is also your key to enjoy the new
  413. look & feel of many applications and other MWB add-ons and extensions.
  414.  
  415. MagicWB  is  distributed as shareware.  Get yourself the latest FREE PUBLIC
  416. RELEASE of MagicWB now:  It is called
  417.  
  418.                              ----------------
  419.                               MagicWB21p.lha
  420.                              ----------------
  421.  
  422. and  can  be found everywhere on Aminet (or your local BBS or public domain
  423. series).   Install it and witness the instant magic it performs on your old
  424. Amiga  Workbench.   Also  included  is the latest SASG registration program
  425. with which you can order and get the full registered version of MagicWB.
  426.  
  427.              If you want to order directly, feel free to send
  428.  
  429.                   DM 30.- or US$ 20.- (cash, no checks!)
  430.  
  431.                                     to
  432.  
  433.                             Martin Huttenloher
  434.                              Am Hochstraess 4
  435.                                D-89081 Ulm
  436.                                  Germany
  437.  
  438. You  may  also  choose  to visit the official MagicWB homepage on the world
  439. wide  web.   There you can find the latest news & support and even register
  440. your  MagicWB  online  (which is much more comfortable and faster). You can
  441. even  benefit  from  various  special offers & discounts for MagicWB if you
  442. order through our website!  Come and visit MagicWB at:
  443.  
  444.                           ----------------------
  445.                            http://www.sasg.com/
  446.                           ----------------------
  447.  
  448.               Save 20% by using the discounts on our website!
  449.  
  450.            Ordering online also saves you a lot of time and work!
  451.  
  452.  
  453.  
  454. WrapGuide is Copyright 1994-1995 Udo Schuermann
  455. All rights reserved
  456.